home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 039a / artcpy20.zip / ARTCOPY.DOC next >
Text File  |  1991-11-17  |  14KB  |  381 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                    A R T C O P Y
  10.  
  11.                                    Version 2.00
  12.  
  13.                                 BGI Device Drivers
  14.  
  15.                            for Hewlett Packard LaserJet
  16.  
  17.                        Epson Compatible Dot Matrix Printers
  18.  
  19.                                         and
  20.  
  21.                                  HPGL Pen Plotters
  22.  
  23.  
  24.                       Copyright (C) B. McAra Software 1991
  25.                                 All Rights Reserved
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.           ArtCopy
  35.           License Agreement
  36.  
  37.  
  38.                   ArtCopy is the property of B. McAra Software. Users
  39.           are permitted to use this software subject to the following terms
  40.           and conditions:
  41.  
  42.           You may use this software on a single machine and make copies
  43.           of this software for backup purposes.  Other than this you
  44.           may use this software as if it were a book - meaning it may
  45.           be used by any number of people and may be moved from one
  46.           computer to another providing that there is no possibility
  47.           that it may be used by more than one person at one time. In
  48.           the case of the Introduction Package you may give copies to
  49.           others provided that the entire package (all files) are included
  50.           and that no modifications are made to the files.  Although
  51.           the Introduction Package is free I request that you register
  52.           your copy with me (at no charge) in this way I can notify you
  53.           of updates.
  54.  
  55.           Programs written with or using ArtCopy may be used, given away
  56.           or sold provided that such programs bear a copyright notice
  57.           either your own or "Created Using ArtCopy (C) B. McAra Software
  58.           1990, All Rights Reserved" and that only the .BGI files are
  59.           distributed with such programs (eg: no source or support files
  60.           which are part of ArtCopy or were created with ArtCopy may
  61.           be included).  In the case of the Introduction Package the
  62.           entire package must be distributed with your program in un-
  63.           modified form.  Developers Package licensees may distribute
  64.           the file SETUPPRN.EXE along with the BGI files.
  65.  
  66.           Limited Warranty:
  67.  
  68.           I will replace the original disks for free for a period of
  69.           one year in the case of physical defects provided you return
  70.           the defective disk. I specifically disclaim all other warranties
  71.           express, implied or statutory including but not limited to
  72.           merchantability or suitability for a particular purpose. In no
  73.           case will I be liable for any loss of business profit or any
  74.           other damage including but not limited to special, incidental,
  75.           consequential or other damages.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.           ArtCopy
  83.  
  84.           CONTENTS
  85.  
  86.  
  87.  
  88.  
  89.  
  90.                   Introduction
  91.  
  92.                   Using the ArtCopy Drivers with Borland Compilers
  93.  
  94.                   User Configuration Files
  95.  
  96.                   Order Form
  97.  
  98.                   Enhancement Request/Bug Report Form
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.           ArtCopy
  106.           Introduction
  107.  
  108.                   ArtCopy is a collection of printer driver files which
  109.           make use of the Borland Graphic Interface to provide programmers
  110.           who use Borland compilers (Turbo Pascal, Turbo C, C++ and Prologue)
  111.           with a convenient way of producing hard-copy output of screen
  112.           graphics.
  113.  
  114.                   These drivers do not merely "dump" screen buffers to the
  115.           printer.  The full resolution of the output device can be used.
  116.           Graphic library calls such as Line, Circle, PieSlice etc. produce
  117.           output on printers and plotters.
  118.  
  119.                   ArtCopy is written in assembler to maximize speed and
  120.           to minimize memory requirements leaving as much memory as possible
  121.           for your programs and data.  Since printers like the HP LaserJet 
  122.           can produce full page output at 300 dots per inch the graphics 
  123.           buffer could be as large as 1 megabyte.  ArtCopy uses temporary
  124.           files or Expanded Memory (EMS) to swap data to disk thus keeping 
  125.           conventional memory demands of the driver to about 5000 bytes.
  126.           If Expanded Memory (EMS LIM Specification) such as Intel Aboveboard 
  127.           or CEMM, is available the drivers will use this for rendering 
  128.           graphics otherwise the drivers will use a temporary disk file.
  129.           The temporary file can be directed to a RAM disk to maximize speed 
  130.           (Developers Package only).
  131.  
  132.                   ArtCopy is available in two versions: an Introduction
  133.           Package which provides basic printer functionality with BGI
  134.           files for laser printers, dot matrix printers and HPGL plotters
  135.           and The BGI Developers Package which provides more advanced
  136.           printer support including user configuration settings and
  137.           complete source code.
  138.  
  139.                   The Introduction Package is available for free - include $5
  140.           for shipping and handling and can be used to create programs for
  141.           sale or distribution subject to certain restrictions (see
  142.           Licensing Agreement). The Developers Package is available for
  143.           $20 plus $5 shipping and handling and provides full customization
  144.           capabilities.  Programs created with the Developers Package may
  145.           include user customized drivers or drivers which have been
  146.           incorporated into the user program itself.
  147.  
  148.                   Upgrades from version 1.00 or 1.10 to version 2.00 of the
  149.           Developers Package can be ordered for $5.00.
  150.  
  151.  
  152.  
  153.  
  154.  
  155.           ArtCopy
  156.           Using ArtCopy with Borland Compilers
  157.  
  158.  
  159.                   ArtCopy driver files are loaded by the graphics library
  160.           supplied with your Borland compiler in the same way that .BGI
  161.           screen drivers are except that one extra step is required:
  162.           using the InstallUserDriver function.  See your compiler manual
  163.           for details and review the sample code provided.
  164.  
  165.                   Printers differ from screens in several important ways
  166.           from a programming point of view.  First of all printers are
  167.           attached to the computer by means of serial or parallel ports
  168.           or a network device.  ArtCopy uses DOS device handles to
  169.           access printers however they are attached.  Secondly dot matrix
  170.           and laser printers require that graphics be encoded as "rasters".
  171.           A raster is a series of bytes with bits representing dots where
  172.           pins will hit or toner will be deposited.  This means that the
  173.           output must be prepared for the entire graphic page and then
  174.           dumped to the printer.  ArtCopy uses a temporary file or EMS to 
  175.           store the rasters while the picture is being created thus sufficient
  176.           disk space or Expanded Memory must be available at run time.
  177.  
  178.                   In the case of the Introduction Package the MATRIX and
  179.           HPPCL (LaserJet) drivers send output to the first parallel port
  180.           on the PC and the HPGL (plotter) driver sends output to the COM1
  181.           device.  The Developers Package drivers use the .CFG file to
  182.           send output to whatever device is required. A set up program is
  183.           supplied to modify these settings.
  184.  
  185.           Communications Settings
  186.  
  187.                   Device communication parameters are not set by the BGI
  188.           driver.  If the printer or plotter is attached to a serial port
  189.           the port should be set up by your program or by the DOS MODE
  190.           command (eg: MODE COM2:9600,e,7,1,p) before starting the program.
  191.  
  192.           Scaling and Device Independence
  193.  
  194.                   To maintain device independence your programs should
  195.           avoid using absolute values for graphic coordinates.  Instead
  196.           use GetMaxX and GetMaxY functions after calling InitGraph
  197.           to obtain these values and then scale all coordinates to these
  198.           values.
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.           ArtCopy
  206.           Using With Borland Compilers
  207.  
  208.           Color
  209.  
  210.                   The HPGL driver allows for multi-color drawings by
  211.           selection of pens.  The SetColor function will cause the plotter
  212.           to select the pen which corresponds to the color number parameter.
  213.           SetColor(0) will cause the plotter to put the pen away.  Your
  214.           program should prompt the user to mount pens in the correct order
  215.           before issuing drawing commands.
  216.  
  217.           Paper Size
  218.  
  219.                   The Introduction Package always produces portrait mode
  220.           output of half-page size on 8 1/2 x 11 pages on Laserjet and
  221.           matrix printers.  The Developer Package provides separate drivers
  222.           for full page landscape mode drawing on these printers (MATRIXF
  223.           & HPPCLF).
  224.  
  225.                   The HPGL plotter driver maps user coordinates to plotter
  226.           P1 and P2 points.  These points are determined by the paper
  227.           size switch on the plotter or may be changed by the user from
  228.           the plotter control panel.
  229.  
  230.           Temporary Files
  231.  
  232.                   If Expanded Memory is not available ArtCopy uses a 
  233.           temporary file to hold the graphics raster data in order to 
  234.           minimize conventional memory requirements. By default this 
  235.           file (TEMP.$$$) is created in the current directory at
  236.           run time and deleted when you call CloseGraph.
  237.  
  238.                   The Developers Package allows you to control which drive
  239.           or directory is used. A .CFG file contains the drive and path
  240.           names as required for each driver. Directing the temporary file
  241.           to a RAM disk will improve the speed of the driver.  However
  242.           for maximum performance the use of Expanded (EMS) Memory is
  243.           strongly recommended.  My testing indicates up to a 20:1 speed
  244.           advantage of EMS over a RAM disk.
  245.  
  246.                   If EMS is not available your program should ensure that 
  247.           sufficient disk space is available at run time for the temporary
  248.           file.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.           ArtCopy
  257.           Configuration File
  258.  
  259.  
  260.                   The Developers Package contains drivers which use
  261.           configuration files to determine which port will be used by
  262.           a driver and which drive and directory will be used for
  263.           temporary files.  These files use the same name as the driver
  264.           they are used with and have an extension of .CFG.  For
  265.           example HPGL.BGI will use HPGL.CFG.
  266.  
  267.                   The Developers Package also includes a configuration
  268.           editor (SETUPPRN.EXE) which can be used to change the CFG files.
  269.           This program may be included with any programs you sell or distribute
  270.           to allow users to easily change the CFG file.
  271.  
  272.  
  273.  
  274.  
  275.  
  276.           ArtCopy
  277.           Order Form
  278.  
  279.           Name ....................................
  280.  
  281.           Address .................................
  282.  
  283.           City ...............  State/Prov ........
  284.  
  285.           ZIP/Postal Code .........................
  286.  
  287.           Phone Number    (. . .) . . . - . . . .
  288.  
  289.           I program in:  --- Turbo Pascal  ---Turbo C   --- Borland C++
  290.  
  291.                          --- Other (specify) ..........................
  292.   ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  293.   Please forward the following:          Price    Shipping and    Total
  294.                                                    Handling
  295.   --- ArtCopy Introduction Package       Free        $5.00        $5.00  -----
  296.              
  297.   --- ArtCopy Developers Package         $20.00      $5.00       $25.00  -----
  298.  
  299.   --- ArtCopy Developers Upgrade         Free        $5.00        $5.00  -----
  300.  
  301.   Saskatchewan Residents Add 7% PST                                      -----
  302.  
  303.   Canadian Residents Add 7% GST                                          -----
  304.  
  305.   Total                                                                  -----
  306.  
  307.   --- ArtCopy Introduction Package
  308.       REGISTRATION ONLY                  Free        Free
  309.  
  310.               Version Number (See First Page of this DOC File)   ......
  311.      =====================================================================
  312.         Check one:
  313.  
  314.           ....Cheque or Money Order Enclosed
  315.  
  316.           ....Please charge to my VISA/Master Card as indicated below:
  317.  
  318.           VISA Card Number   .............................. Expires .......
  319.  
  320.           Signature .......................................
  321.  
  322.         (Sorry I can no longer accept MasterCard orders.)
  323.      ====================================================================
  324.           Mail this form with your cheque or money order to:
  325.  
  326.                   B. McAra Software
  327.                   1449 Shannon Road
  328.                   Regina, Saskatchewan
  329.                           S4S 5L4
  330.  
  331.  
  332.  
  333.  
  334.           ArtCopy
  335.           Enhancement Request/BUG Report
  336.  
  337.           Registration Number .....................
  338.  
  339.           Name ....................................
  340.  
  341.           Address .................................
  342.  
  343.           City ...............  State/Prov ........
  344.  
  345.           ZIP/Postal Code .........................
  346.  
  347.           Phone Number    (. . .) . . . - . . . .
  348.  
  349.           Date .................
  350.  
  351.  
  352.           Description of Problem
  353.  
  354.           .................................................................
  355.  
  356.           .................................................................
  357.  
  358.           .................................................................
  359.  
  360.           .................................................................
  361.  
  362.           .................................................................
  363.  
  364.           Suggested Solution/Improvement
  365.  
  366.           .................................................................
  367.  
  368.           .................................................................
  369.  
  370.           .................................................................
  371.  
  372.  
  373.           Mail to:
  374.  
  375.           B. McAra Software
  376.           1449 Shannon Road
  377.           Regina, Saskatchewan
  378.                   S4S 5L4
  379.  
  380.  
  381.